.. _ecNet_SlvComErrSum_SetEnable:

ecNet_SlvComErrSum_SetEnable
============================
----------------------------


SYNOPSYS

.. code-block:: none

 t_bool ecNet_SlvComErrSum_SetEnable(
   t_i32 NetID, 
   t_bool IsEnable, 
   t_i32 *ErrCode)


DESCRIPTION
`````````````  

- 마스터에서 각 슬레이브의 통신 에러 카운트값을 누적 관리하는 기능의 활성화 속성을 설정합니다.

- 대부분의 이더캣 슬레이브는 통신 에러를 카운트하는 카운터 레지스터를 제공합니다. 그런데 그 카운터 레지스터는 1바이트 크기의 레지스터라서 255개의 에러만 카운트하고 그 이상이 되면 0부터 다시 카운트하게 됩니다.

- 마스터의 통신에러 카운트 누적 기능은 주기적으로 슬레이브들의 에러카운트 값을 읽어서 누적하여서 슬레이브의 카운터 레지스터가 오버플로우되어서 카운트값이 리셋되는 현상을 보완하는 기능입니다.

- 단, 통신 에러 카운트 누적 기능을 활성화하면 마스터가 주기적으로 슬레이브들의 레지스터를 읽고, 클리어하는 작업을 수행해야 하므로 네트워크에 부하를 가중하게 됩니다.


PARAMETER
`````````````

- NetID : 사용자가 사용 할 Network 번호

- IsEnable : 활성화, 비활성화를 선택합니다.


+-------+------------------------------------------+
| Value | Meaning                                  |
+=======+==========================================+
| 0     | 에러 카운트 누적 기능을 비활성화 합니다. |
+-------+------------------------------------------+
| 1     | 에러 카운트 누적 기능을 활성화 합니다.   |
+-------+------------------------------------------+

- ErrCode : 이 매개 변수를 통하여 현재의 에러 코드를 반환합니다. 단, 이 매개 변수에 NULL을 전달하면 에러 코드를 반환하지 않습니다.




RETURN VALUE
`````````````
  
함수 수행의 성공 여부를 반환합니다.

+-------+--------------------------------------+
| Value | Meaning                              |
+=======+======================================+
| 0     | 함수 수행에 실패하였음을 의미합니다. |
+-------+--------------------------------------+
| 1     | 함수 수행에 성공하였음을 의미합니다. |
+-------+--------------------------------------+

.. seealso:: :ref:`ecNet_SlvComErrSum_GetEnable`  :ref:`ecNet_SlvComErrSum_ClearAll`